home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Collections: Taifun
/
Taifun 194 (1992-03-10)(Manewaldt, A.)(DE)(PD).zip
/
Taifun 194 (1992-03-10)(Manewaldt, A.)(DE)(PD).adf
/
AKCC
/
Dokumentation
/
AKCC_ENG.doc
< prev
next >
Wrap
Text File
|
1992-02-29
|
28KB
|
703 lines
==============================================================================
==============================================================================
=== AKCC V1.4.001 rel. 0801-92 ===
==============================================================================
=== ( S H A R E W A R E ) ===
==============================================================================
=== ===
=== (c) 1990-92 by Andreas Ralph Kleinert ===
=== Grube Hohe Grethe 23 ===
=== W-5900 Siegen 1 ===
=== Germany ===
=== ===
==============================================================================
==============================================================================
=== (Runable under OS V1.2 (V33.xyz) to OS V2.04 (V37.175), ===
=== needs 'akcc.library' V35.1 or higher. ===
==============================================================================
'AKCC' is (C)opyright 1990-92 by Andreas R. Kleinert
and may be freely distributed. A payment of the SHARE-fee is
welcomed, but not 'forced'. A possibly amount as a copy-fee per disk
should not be higher than $7.5 (10 DM) or five as much as the price
for the empty disk.
SUPPORTED by me is a fee which is just as high as the costs of the dis-
tributor are.
AKCC may not be distributed divided into parts (only complete) !!!
Parts of AKCC are :
- this Doc-File
- the AKCC-Commands
- the other content of this directory, if marked as a part of AKCC.
----- Docfile-Version : V1.4.001-A-0801-92 -----
=============================================================================
= DESCRIPTION : =
=============================================================================
'AKCC V1.4.001' is packet of CLI-/Shell-Commands for the Amiga, which
is intended to make working with the AMIGA, especially for beginners,
but also for experienced users, somewhat easier.
There are as well programs which just replace others, which just replace
similar ones, as well as programs, which are completely (?) new.
'AKCC' has no intention to be an concurrent to other CLI-/Shell-Packets
(e.g. to those from ARP or Commodore), but this could not be a serious
thought anyway, in this phase of AKCC's development.
=============================================================================
= ATTENTION : =
=============================================================================
THIS PROGRAM IS SHAREWARE !!!
- What does that mean in this case ?
If you often use this program, please pay the SHARE-fee of $7.5 (DM 15)
to my address. But this is fully voluntarily (this is the reason why
this program has not to be called 'commercial') !!!
When you have paid the fee, you may at a time get the the latest version
from me by sending me enough money for postage/packing and an empty disk.
Please wait at least two or three months before asking for the next ver-
sion update.
This offer is then obsolete and ends, when I'm no longer able (no
matter what reason) to manage the many requests for this program to the
conditions desribed above.
- What will happen, if this offer does no longer stand sometime in the
future ?
Alternatives then :
a) No more enhancements to the program will be made.
(Possible, but not realistic.)
or :
b) This program could be distributed as a kind of COMMERCIAL Shareware,
maybe with better conditions for the people, who already paid the
voluntary Share-fee.
or :
c) This program could be selled as a completely commercial product.
Summary :
If somebody sent me - AFTER becoming this offer obsolete - $7.5 + disk
+ PP, then I'll send all that back, by using the necessary part of the
PP (disk empty), and I'll add an information containing all might be
interested in about the new version of the program (status a,b,c,?).
I also would send the PP and the disk back to the people who already
paid the SHARE-fee sometime before, but maybe for this people together
with a special offer (as described under b) ) for the new version of the
program.
But this is currently all not in a realistic view. I also don't think
that this program now is good enough to have a realistic chance as
a commercial (Share-)Ware.
So think about sponsoring the (voluntarily) Shareware-idea, without
any risks ($7.5 is not much) and get the possibilitie to get quick and
easy updates, directly from the programmer (without any bad changes made
to the original) !
- Necessary information I have to get :
- Current version of the program you own, so that I see, if an update
is already (still) possible or makes sense.
- Your telefon number, full address and BBS (if there).
=============================================================================
= INSTALLATION : =
=============================================================================
Version A :
1. Use the batch-files in this distribution to install AKCC.
(I believe in their correct way of functioning - if they don't, just
use the 'Version B' method ...)
Version B :
1. Copy the (yet) 37 'AKCC' commands into the 'C'-Directory on your
System- or on any other disk.
2. Copy the actual version of the 'akcc.library' (V35.1 ) into the
'LIBS'-Directory on your System- or on any other disk.
Version C (if you've got a lack of disk-space ...)
1. Just copy the part of the (yet) 37 'AKCC' commands THAT YOU NEED
into the 'C'-Directory on your System- or any other disk.
2. Copy the actual version of the 'akcc.library' (V35.1 ) into the
'LIBS'-Directory on your System- or on any other disk.
Also :
... create (please) the logical Devices 'T:', 'ENV:' and 'CLIPS:'
(e.g. as follows) !!!
MakeDir RAD:t ; In the startup-sequence :
MakeDir RAD:env ; Set 'FailAt' on a higher level,
MakeDir RAD:clipboards ; if using 'RAD:', because
Assign T: RAD:t ; 'MakeDir' will produce errors
Assign ENV: RAD:env ; after a reset.
Assign ENV: RAD:clipboards ; ('RAD:' is recoverable, as you
; know ...)
For creating 'ENV:' you may (and should) use the AKCC-Command
'EnvAct' instead (if possible) !
... please increase the stack size on a higher level !
It's useful to work with a stack size of at least 30000 Bytes,
which is useful for all programs, which work recursively
(not only Compilers do so !!!).
Warning : It is not practicable in all cases to mix up several different
Versions of 'AKCC', includeing the 'akcc.library', because
of possible incompatibilities !
(Look into the file 'akcc.library.doc' !)
Also :
Not all of the commands may be made resident, so don't do it !
(I work for it !)
=============================================================================
= HOW TO USE : =
=============================================================================
Each single 'AKCC'-Command prints out a short desrciption of itself,
when it is started with a single '?' as its only parameter.
This description always looks like this :
'USAGE : x <x> <x> [...]'
The same thing happens, if a command was used wrong, but only if it has
not been used TOO WRONG ...
=============================================================================
= COMMAND SUMMARY : =
=============================================================================
(Commands marked with a '*' support WildCards ('*'/'#?') and/or the
recursive method of working on directories (option '-a')).
A. WB-/ARP-similar Commands
1. AD
-> (changes the current directory.
2. ComLoad
-> (starts a program as a process, with access to the
active CLI-/Shell-Window (where started from),
which can't be closed (temporarily) because of this.)
* 3. Comment
-> (adds remarks to a file.)
4. Display
-> (displays the contents of a file on the Screen or
a virtual device (e.g. PRT:, CON:, SER:, ...),
or into an other file. Supports octal and hexadecimal
printing.)
* 5. Duplic
-> (copies files/dirs.)
6. EnvAct -> (is able to manage all affairs with environment-varia-
bles easy and quickly.)
* 7. ExtShow
-> (shows a directory, protection bits, date and comment.)
* 8. ExtShow-2
-> (special version of 'ExtShow', only for OS >= V2.04.)
9. KAssign
-> (manages assignments.)
10. KAssign-2
-> (special version of 'KAssign', only for OS >= V2.04.)
* 11. Kill
-> (deletes files/dirs.)
12. KInfo -> (gives Information of all mounted Volumes, e.g. Disks
or RAM-Disks.)
13. NewName
-> (renames files/dirs.)
14. NewDir
-> (creates a new directory or a complete new path :
e.g. 'df0:Texts/Letters/Private'.)
* 15. ProSet
-> (sets new protection bits for a file
[from : hsparwed].)
16. PriSet
-> (changes the priority of a task/process via name-
reference.)
17. PosPrint
-> (prints out a text at a postion on the screen, which
can be defined before.)
18. PrefSet
-> (ermoeglicht das Veraendern einiger Systemeinstellun-
gen [z.B. Tastenwiederholungszeit], entweder per
'Menue' oder per Parameteruebergabe in der Kommando-
zeile)
* 19. Show
-> (zeigt das Inhaltsverzeichnis)
20. ViewDate
-> (zeigt das aktuelle Systemdatum und die Systemzeit an.)
B. New Commands
21. CheckExec
-> (shows some values of the 'ExecBase' ans checks some
vectors to avoid viruses.)
22. ExecLibs
-> (informs about all resident libraries.)
23. ExecLibs
-> (shows free memory.
The special : Is able to write the result into an
environment variable !!!)
24. ExecSems
-> (informs about all resident semaphores.)
25. ExecRes
-> (informs about all resident resources.)
26. ExecIRupts
-> (informs about all resident interrupts.)
27. ExecDevs
-> (informs about all resident devices.)
28. ExecPorts
-> (informs about all resident ports.)
29. BigSize
-> (sizes the active window to PAL-, NTSC- or the
biggest possible size, or brings it just to a
wished X/Y-size (everything possible).
Also moves the window into the left, top corner of
the screen.)
30. HunkShow
-> (shows the HUNKS of a program or object-file.)
31. KillTask
-> (deletes a task form the system's lists.)
32. LED
-> (turns the Audio-Filter (PowerLED) on or off.)
* 33. Move -> ('moves' files/dir from one device/dir to an other.
Copies the Source, then deletes it => combination
of 'Kill' and 'Duplic'.)
34. PosLeft
-> (moves the active window to 0/0.)
35. Texter
-> (prints out a text on the screen OR on a parallel
printer.
options : normal, bold, underlined, italic,
reverse, free lines)
Uses for parallel printing 'PRT:' or, if 'PRT:'
not available, 'PAR:'.)
36. Title
-> (changes the text to be shown in the title bar of the
current window and (optional) screen.)
37. ExecTasks
-> (informs about all active tasks.)
=============================================================================
= REMARKS TO SOME OF THE COMMANDS : =
=============================================================================
- EnvAct
---> SHOULD be called in the startup-sequence.
e.g. as follows :
EnvAct INIT RAM:
Creates the directory 'RAM:env', assigns it to 'ENV:', and
the environment variables 'AKCC' and 'AKCC-LIB'.
- NewDir
---> NewDir also creates complete paths (recursive), so that con-
structions like 'RAM:tmp/comp/txt/1' etc. are also legal !
One command suffices !
- Texter
---> All the styles are combineable (for the printer as well as for
the screen).
- ViewDate
---> There aren't any changes possible yet (you may call it
a 'ReadOnly' command ...)
- PrefSet
---> - be careful by changing the 'KEY...'-values !!!
- manipulations on the TOPAZ-charset become only important, if
a new window is opened.
- KillTask
---> Be careful by killing any tasks/processes (especially
System-Tasks).
=============================================================================
= VERSION-'HISTORY' : =
=============================================================================
V1.0 :
- first version with (now I know) many bugs and (seen from now) not much
commands
------------------------------------------------------------------------------
V1.1 :
- Decreasement of the Code-Size
- many new Commands (e.g. the 'Avail...'-Commands are new)
- some small bug fixes
- optimizations on the Source-Code(s)
------------------------------------------------------------------------------
V1.2 :
- Decreasement of the Code-Size
- Construction of a special library ('akcc.library')
- some small bug fixes
- optimizations on the Source-Code(s)
------------------------------------------------------------------------------
V1.3.001 :
- new, improved 'Outfit' for all the commands
- Decreasement of the Code-Size of most of the programs
- Better Error-Control-Routines and (internal) requests for all commands
- bug fixes (...)
- Request for 'akcc.library' V33 (oder higher)
- Removement of incompatibilities with the new library-version
- especially improved commands :
- ExtShow (more information)
- Prior (now priority of EACH task/process changeable)
- HunkShow (now also object- and other files supported)
- etc. ...
- new commands :
- ComLoad (starts a program as a new process)
- ViewDate (shows current date and time in the system)
- ViewAssigns (shows and modifies assignments)
- SetPrefs (modifies several preferences)
- KillTask (removes a task/process)
------------------------------------------------------------------------------
V1.3.002 :
- corrected outfit (info-texts)
- Decreasement of the Code-Size of some of the programs
- Better Error-Control-Routines and (internal) requests for all commands
- bug fixes (...)
- Request for 'akcc.library' V34 (oder higher)
(upward-compatibility)
- renamed commands :
new name : old name until V1.3.001 :
- ExecTasks TaskStates
- ExecLibs AvailLibs
- ExecSems AvailSemaphores
- ExecRes AvailResources
- ExecIRupts ActiveInterrupts
- ExecDevs AvailDevices
- ExecPorts AvailPorts
- KAssign ViewAssigns
------------------------------------------------------------------------------
V1.3.003 :
- Decreasement of the Code-Size of some of the programs, compared with
AKCC V1.3.002
- Optimization and enhancements of the AKCC-commands
- Better Error-Control-Routines and (internal) requests for all commands
(again)
- bug fixes (...)
- new commands :
- InitAKCC
- CheckExec
- ReadEnv
- WriteEnv
- renamed commands :
new name : old name until V1.3.002:
- Text Print
- WildCard ('*') and/or '-a'-support was integrated into the following
commands :
- Show ( -a)
- ExtShow ( -a)
- Comment (*/-a)
- Pro (*/-a)
- especially improved commands :
- Text (vorher 'Print') (several styles)
- Dump (several styles)
- KAssign (information about type of assignments)
- ExecPorts (more informationen)
- ExecLibs (more informationen)
- ExecDevs (more informationen)
- ExecSems (more informationen)
- etc.
------------------------------------------------------------------------------
V1.3.004 :
- Request for 'akcc.library' V34 (or higher), more than 50 % shorter
- especially improved commands :
- ExecTasks (more information; some changed routines)
- and other enhancements
- Bugs fixed :
- Show + ExtShow ( -> there were some GURUs/'DeadLocks')
- ExecLibs ( -> OpenCount (#) sometimes out of the Screen
(Border))
- and some other small bugs
- fixes of some 'technical' and 'optical' bugs
- fixes of some incompatibilities (e.g. with ARP)
- some commands are longer, but therefor better !
------------------------------------------------------------------------------
V1.3.005 :
>>> rel. 2311-91 :
- New info-texts, to make them readable under OS V2.04
(BOLD + ITALIC looked quite terrible !)
- new commands :
- EraseEnv
- Move
- renamed commands :
new name : old name until V1.3.004 :
- PriSet Prior
- ProSet Pro
- PrefSet SetPrefs
- especially improved commands :
- HunkShow (several new types of HUNKS, fixed some bugs.
There are still not all types of HUNKS suppor-
ted fully.)
- Exec...-Befehle (more information, now CONsole-'dependent')
- BigSize (Size now freely chooseable <=> or use of the
PAL-, NTSC- or biggest possible size !
-> value form GfxBase)
- PosLeft (also supports other values than 640/256)
- CheckExec (small enhancements)
- and many other enhancements
- Bugs fixed :
- HunkShow ( -> as described above)
- Exec...-Befehle (Some problems with I/O under OS V2.04, now error-
free via usind standard-I/O (CONsole))
- Dump (used MODE_NEWFILE, instead of MODE_OLDFILE.
Simple, but deadly.)
- ComLoad (now generally functions)
- and some other small bugs
>>> rel. 2711-91 :
- in rel. 2311-91 there was an error with 'KAssign V1.3.005', which
was only useable under OS V2.04. This command now is named
'KAssign-2'. 'KAssign' is also new there, but for OS V1.2 to V2.04.
'KAssign-2' is a NEW COMMAND, so !
------------------------------------------------------------------------------
V1.3.006 :
- Request for 'akcc.library' V34.06, more functions !
- all WildCard-commands now support also '#?' !!!
- alle commands now support the break-events envoked by CTRL-C / CTRL-D,
so most of the allocated memory will be given free (this was not pos-
sible in all cases before !)
- new commands :
- InitEnv
- especially improved commands :
- ExtShow (now with WildCard-support !)
- Show (now with WildCard-support !)
- Kill (some arrangements have been changed, so that
there isn't any longer the dnager to delete
directories you dont' want, if not chosen the
'-a'-option (I hope ...).)
- NewDir (now also complete Paths !
e.g. 'df0:s/1/2/3'.)
- and many other enhancements
- Bugs fixed :
- ExtShow / ViewDate (Fixed a bug in the 'akcc.library', see its doc-
file !)
- Show (colors are restored after exit ; info-text now
error-free)
- Duplic / Move /
Kill (The 'known bugs' of Duplic - and also Move and
Kill - are now fixed (see 'akcc.library.doc') !)
- Kill (completely new recursive Delete-Routine (the old
one had some evil bugs !!!)!)
- and some other small bugs
------------------------------------------------------------------------------
V1.3.007:
- 'Merging' of commands :
- EnvAct (merges the functions of the four former com-
mands 'InitEnv', 'WriteEnv', 'ReadEnv' and
'EraseEnv' into ONE command.)
- Texter (merges the functions of the both former com-
mands 'Text' and 'Dump' into ONE command for
printer AND screen text-output.)
- 'Killing' of commands :
- InitAKCC (This command has no useful effect any longer.)
- Bugs fixed :
- KAssign / Kassign-2 (Disk-/Filesystem-Types are now correctly recog-
nized.)
- KAssign (Path-Names are now completely listed.)
- ExecInterrupts (List of 'IntVects' is now functionable.)
- Exec... (Negative priorities of nodes weren't shown cor-
rectly ! Now alright !)
- new commands :
- KInfo
- ExecMem
------------------------------------------------------------------------------
V1.4.001:
- new library-version (V35) and increase of version number to V1.4 !
- especially improved commands :
- CheckExec (is now also abled to show Bootblocks of Disk !)
- KAssign-2 / KAssign (are more than 3000 Bytes shorter, but therefo-
re no longer interruptable via CTRL-C/-D.)
- KAssign (is nearly 350 Bytes shorter.)
- KillTask / SetPri (no distinction beetwen upper- and lowercase
any longer. WildCards supported.)
- LED (New : Batch-Mode. Result is WARN (5), if the
Power-LED is on, 0 if it is not.)
- and many other enhancements
- Bugs fixed :
- CheckExec (Fixed bug in CHIP-/FAST-Memory values !)
- and some other small bugs
- new commands :
- ExtShow-2
------------------------------------------------------------------------------
------------------------------------------------------------------------------
KNOWN BUGS :
- AKCC :
Version V35.1 of the 'akcc.library' is downward-compatible to
version V34.06 and V34.05, but older versions (or newer) may
not be !!!
-> Fixing : Don't mix versions, if you aren't really sure !
- 'AD' :
Some Shells, like the OS-2.04-Shell, or the 'WShell', which
shows the current directory in the title bar of the window or
in the prompt of the command-line, don't examine the changes
made by 'AD'.
-> Fixing : Don't use this shells, live with it, or turn their
special function off (e.g. with 'Prompt').
- 'ComLoad' :
Some commands expect at least one parameter in their command-
line-stream, even if it is an empty string ('').
The 'Dir'-command of AmigaDOS needs e.g. a Path (even if it's
only "").
-> Fixing : Give 'em what they want ! (Use "" !)
(for KNOWN BUGS of the 'akcc.library', see 'akcc.library.doc' !)
------------------------------------------------------------------------------
------------------------------------------------------------------------------
Possible enhancements in future versions :
- More support of Amiga OS 2.04 (>= V37.175)
- More new AKCC-commands (e.g. more tool-like commands)
- More, more, more, ...
- Bug fixing (I am sure that there are still some, even if I didn't found
them yet !)
Please send me BUG-reports !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
=============================================================================
= INFORMATION ABOUT THE 'akcc.library' : =
=============================================================================
The 'akcc.library' has it's own documentation.
Please read it carefully.
Thanks !
=============================================================================
= COPYRIGHTS : =
=============================================================================
=============================================================================
= 'akcc.library' (part of AKCC) =
= (c) 1990-92 by Andreas R. Kleinert. =
=============================================================================
= Copyrights of other mentioned products/programs are to find in the =
= manuals of these and are not listed explicitely at this place here. =
=============================================================================